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COPYRIGHT NOTES 


This manual end the object code (contained on t lorry disk) is serial 
numbered and protected by a legitimate copyright. No part ot this 
manual may be copied or reproduced without the express written 
permission ot the copyright owners Carl Moser. You may make a 
backup copy ot the diskette in order to protect your copy ot this 
sottware. It is though a Federal crime to make a copy ot the 
manual or floppy disk for use by anyone other than the individual 
who purchased this software or the individual a company purchased 
the software for. 


Thus.- you are in violation of Federal Copyright Laws if you do one 
tat the following- 

- Make a. copy of the manual. 

- If you allow someone else to use your copy (or backups) 
of the object media (diskette) whi le you retain a copy 
or are using a copy. 

- If you.' your company., or others purchase one or more 
copies and more individuals simultaneously use this 
software than the number purchased. 

- If you allow someone else to do the copying of this 
material., you will be considered as a party to the 

infringement. 

A reward will be provided for anyone who supplies information which 
leads to the prosecution of parties who violate this copyright. 

We do not presume that you are or will violate copyright laws. Most 
users do not. Some though do.- and may not realize the consequences 
for violation of this Federal Law. Penalities and fines can be 
quite severe for both individuals and companies who infringe this 
copyright. 

Most important ly.. software houses like the one which wrote this 
software have incurred a. tremendous investment that can 
not be fully recovered if current illegal copying continues. 

Also., updates and program maintenance will have to be terminated 
if the return on investment is not sufficient. 

Finally.* an expressed appreciation is given to the purchaser of 
this software. We hope that you find it a valuable and 
worthwhi le investment. 

If you encounter any problems.- contact us a.t : 

Eastern House Software 

Car 1 Moser- 

3239 Linda Drive 
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1. INTRODUCTION 

This Macro Assembler (ASSM> and Text Editor (TED) resides simultaneously 
in 10K bytes ot memory £5060—77FF). The collective assembler and 
text editor is reterred to as MAE. MAE was desisned to work with the 
Commodore 32K PET (new ROMs) and the 2040 Disk Drive. Versions 
also exist tor 40 column PETs retrotitted with 4.0 RuMs and tor the 

CBM 80 column PETs (8032). 

As mentioned.- the MAE object code occupies 10k ot memory. In addition 
to thissutticient memory must be allocated tor the text tile 
and labe 1 tile (symbol table). Approximately 8k is sutticient 
memory tor the text tile tor small programs or larger programs it 
assemb led trom disk. It an executable object code tile is to be 
stored in memory durins assembly.* sutticient memory must be provided 
tor that also. On cold start entry ($ 5000 ).' MAE will set the tile 

boundaries as to 1lows : 


Text File 
Label File 
Re locatable 


Object Butter 


$3080-$4FFC 

$1800-$2FFC 

$7880 


These boundaries leave memory tor the extended monitor ($1088—$17FF).. 
the DOS support at upper memory.* and memory tor Basic and Machine 

Lansuase prosrams ($0400-$1000). 

The label tile and text tile that MAE senerates is position 
independent and may be located practically anywhere in RAM memory. 
The object code tile location is dependent on the besinnins ot 
assembly (.BA pseudo op) and the .MC pseudo op. 

MAE was desisned such that records in the label tile and text tile 
are variable in lensth and directly dependent on the number ot 
characters to be stored. This results in more etficient 
utilization ot memory. 

Some unique teatures ot MAE are : 

. Coexists with PET Basic. 

. Macro.* Conditional Assembly.* and Interactive Assembly. 

. Labe Is up to 31 characters in lensth. 

. Auto line numberins tor ease ot text entry. 

. Creates both executable code in memory and relocatable 

object code on disk. 

. Manuscript- teature tor comP*osins letters and other text. 

. Load ins and Storins via. Disk. 

. Supports Serial I/O and/or IEEE printer. 


■ *J 


Strins search and rep*lace capability.* plus other powertu 1 


editins commands. 

. Auto repeat ot any key held down tor 1/2 second. 

. Capability to send command strinss to 2040 Disk. 

MAE uses a prompter character (3) 

to indicate that it is ready to accept commands. Command mnemonics 
reterenced in this document are printed with the prompter 
(example 3BR). When inputt ins a. command.* you should not type 
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" ] " preceedins "the mnemonic. 

Initial entry (or cold start) to MAE is at address $5006. If the 
break command <3BR) is executed.- one may reenter MAE at $5803. 
Initial entry provides the following default parameters : 

. Format = set 
. Manuscript = clean 
. Auto line numberins = off 
. Text file and Label file = clear 

MAE was designed to coexist with PET Basic. This was accomplished 
by preserving Basics zero pase variables. Thus/ on cold start 
entry.. MAE copies all 256 bytes of zero paste to a save area. 
($7600-$76FF). On all exits (via. 3BR/ 3RU/ 3US)/ MAE restores 

these variables. On warm start entry.* MAE swaps zero pa.se with 
+he save area. MAE also uses a number of absolute variables 
at *7700-$77FF. 

Remember-/ MAE is a. 10K system which uses memory from $5000-$77FF. 
Vou should protect MAE from Basic by settina the Basic variable 

HI MEM ($34/ $35) to point to .just below MAE and its text and 
label files. For example., to protect memory above $2080/ 
enter $00 at location $34 and $30 at location $35. 

This software has been extensively tested and is believed to be 
entirely reliable. It would be foolish to guarantee a program 
of this size and complexify to be free or errors. Therefore.- 
we assume no responsibi lity for the failure of this software. 

MAE is protected by a. Copyright. This material may not be copied/ 
reproduced.- stored in a retrieval system.- or otherwise 
dup licated without the written permission of the owner/ 

Car-1 Moser. The purchaser may however make copies of the 
diskette for his own individual use for backup purpose. 

The Purchase of this software does not convey any license to 
manufacture/ modify and/or copy this product in any manner. 


a 


FILES CONTAINED ON THE DISKETTE 


The s u p p 1 ied diske11e contains the fo 


Fi lename 

MAE/DOS.EKE 
EKTRAMON.EKE 
EKTRAMON.INS 
MAE.EKE 
RELOC.EKE 
RELOC.REL 
PET.LIB 
MAE.NOT 
WORDP.EKE 
WORDP.INS 

MLMACROS.MLIB 
SWEET16.MLIB 


Description 




s cses* < 


* 

'X* 

m 


* 


Enhanced BOS Support Program (Wedse) 
Enhancement to PET M.L. Monitor 
and instructions - Courtesy Bill Seiler 
MAE object code 
Re locating Loader object code 
Relocatins Loader relocatable code 
Library of PET ROM locations 
Some notes on MAE 
Word Processor Prosram 
Word Processor Instructions File and 
example of raw text 
File of some Machine Lansuase Macros 
Fi le of SWEET16 Macros (Use with PET16/ 



IEEE.LIB 
SECTOR.CTL 
SECTOR.PGM 

UflRT.CTL 
IJfiRT. M01 
UflRT.M82 
UflRT.M03 
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see #20 end #25 issues of Micro Mass: 
$ IEEE M ao h i r i e L an a u so e Driver' Routines 
$ Ex arm* le prosram which l 1 lustrates use 
of IEEE.LIB - displays disk sector 


l ne > 


# EXAMPLE PROGRAM 
(UflRT Driver) 


Source files in MAE format 


3. ENHANCED DOS SUPPORT PROGRAM 

The first file on the MAE diskette is named MAE/DOS.EXE. 

This file is an enhanced version of the DOS Support program supplied 
by Commodore Business Machines. The standard DOS support commands 
provided are- 

f Load and run Basic program 

/ Load Basic or Machine Lansuaae Program 

> Read disk error channel 

>$n Display directory for drive n 

>cmd Pass command strins to disk drive 

In addition to these commands., the MAE/DOS. EXE_prosram provides 
an auto-repeat key feature and the following MAE support commands- 


AC 

AW 

MC 

MW 

LC 

LW 


Load MAE.EXE# (MAE Assembler/Text Editor) and beyin 

execution at the cold start entry ($5000)_ 

Beain execution at the MAE warm start ($5UUS) 

Load EXTRAMOH.EXE* (Extended Monitor)_and bea in 
execution at the cold start entry ($1y yy) 

Beain execution at the Extramon warm start entry ($y4oy 
L o ad R E L. E X E# (R e 1 o c at i n a L o ad e r) an d b e a i n e x e c u t i o n 

at the cold start entry ($0500) _ 

Bea in execution of Relocating Loader ($U5yU) 


The purpose of these additional commands is to provide a. ciuick and 
convenient means to perform some of the more common MAE functions 
but with minimal keystrokes. To illustrate this., compare the 
follow in-a two methods of load ins and execut i na the MAE. EXE# 
program : 

1) Without MAE Support Commands 1 

/MAE.EXE* 

SVS 2O480 

2) With MAE Support Commands 1 


AC 

The difference is 20 keystrokes versus .just 3! 
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4. TEXT EDITOR <TED> FEATURES 

The TED occupies approximately one-hal-f the total memory space 
of this software. The purpose of the TED is to setup and 
maintain the source tile by interacting with the user via carious 

commands. 

When inputting to the TED.* the user has avai lable the f u 11 
capabilities ot the built in cursor— oriented screen editor- 
plus the additional teature ot automatic repeat ot any key 
h e 1 d d o w n t o r 0.5 s e c o n d. 


When list in-3 to the CRT or printer 
output via the follow in-3 keys : 


ie user ha. 


contro l o 


STOP 

DEL 

OFF 

S I’D m 


Temporari ly halt output tin-3 and await input of or 
the follow in-3 keys. 


eturn t< 


ii 1 !i 


"|^ W I. ,1 fZi 


0*f 


Continue process in-3 but suppre: 
errors. 

Continue outPuttin-3 after STOP 


output except for 


A. Command-- 

The TED provides 27 command functions. Each command mnemonic mus 
be-ain immediately after the prompter <3>. When entered., a 
command is not executed until a carriaae return is given. 

A Ithouah a command mnemonic such as 3PR may be several non—space 
characters in length, MAE only considers the first two. For 
example, 3PR, 3PRI, 3PRINT, and 3PRETTV will be interpreted as 
t h e p r i n t c o m m an d. 

Some commands can be entered w i th van i ous p arameter-s. For exam p 1 
3PRINT 10 206 will print out the text in the text file with line 

numbers between 10 and 200. One must separate the mnemonic and 
the parameters from one another by at least one space. 

Do not use commas. 

A disk filename may be specified in some of the follow in-3 command 
Wherever "'f i le"' is aiven as a command parameter, its format is 

as fo 1 lows : 

Dn "drive •' name" 


where• 


n is the 
drive is 
name is 


dev i ce number < defau It = 8 > 
the disk drive number <0 or 
the file name 


Examp les ar e : 


D9 "1:MAE.NOT" 

D8 "0:RELOC.REL" 
"DOS SUPPORT" 
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H description of each command -follows 1 


3ALPHA 

Tortile shift character set from graphics to lower case 
and vice versa by tosslina PET control at $Eu4c. 


] ASSEMBLE file w 

If file is specified.- load the file into text fi 1 
then beyin assembly with contents of text file. 


e arc 


If w=LIST then generate a listing. 

If i.m=H0L I ST or w not entered then an errors 
will be generated. 


: on ly output 


3AUTO x 

Benin auto line numbering mode with next user entered 
line number, x specifies the increment to be added 
to each line number. Vou may exit auto line numbering 
by entering ,V immediately following the prompted line number 


3 BASIC 

Restore zero page and go to Basic. 


3BREAK 

Restore zero page and go to Monitor 


3 CLEAR 


Clear text file. 
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x 


y 



Copy lines 
number x. 
eciual x. 
this data 


y thru z in the text file to just after line 
The cop ied lines ini llall have line numbers 
flt completion.- there will be two copies of 
- one at x and the original at y. 


]BC "command" 

Pass disk commands to PET 2046 Disk, 
can be entered with the PRINT# Basic 
be entered. 


Any commands that 
statement may 


Example-' Output directory is 3 DC 

Scratch file TEST is 3DC "S^TEST" 

Note: Entry of 3DC with no parameters results in display 

o f err or d is k error c h an nel messas e s . 


3DELETE 


y 


Delete entries in the 
x and y. If only x i 


text fi le 
entered.- 


between line numbers 
only that line is deleted. 


3EDIT t Si t S2 t OR 

String search and replace* or 
See part 8. 


3EDIT n 
interline edit. 


3FIND t Si t 

String search. 
See Part 8. 


3 FORMAT w r. 

Format the text file (where w=SET> or clear the format 
feature (where w=CLEAR>. Format set tabulates the 
text file when outputted. This lines up the various 
source statement fields. 

n specifies the number of characters per label (max. = 
This is used to tabulate the listing. 


•«*1 1 
<w* A «f* 
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3GET f ile y 

Get -file from disk arid store in the text buffer. 

If y is not entered.- store at start of text buffer 
If y is a. line number.- enter following specified 
line number. If y = APPEND then enter following 
current contents of text file. 


Examp les : 


3GET "MEMTEST" 

3GET " 1 : CRTDVR " 1666 

3 GET "6 : UART 11 APPEND 


3HARD w x 

Format for hard copy listins. This feature is designed 
to work with 66 line paaes arid leaves marain at top 
and bottom a Ions* with p aae number. 

3HA SET turns this feature on.- 3HA CLEAR turns this 
feature off. x is the start ins* rase number. 

3HA PAGE advances to tor of next rase. 

Each time 3HA SET is entered.- MAE resets its internal 
line counter to 6. Thus, you must manually adjust 
the rarer in the printer so MAE and the printer- 
are synced. 


3LABELS w 

Print out the entire contents of the label file if 
m.i= ALL or M.I not entered. Print only fixed externa.I 
labels if w=FIXED. Print only internal or proaram 
labeIs if w=PROGRAM. 


3MANUSCRIPT w 

If i.y=SET, line numbers are not outputted when executing 
the 3PR command. If w=CLEAR, line numbers are outputted 
when the 3PR command is executed. Assembly output 
isnores the 3MA command. If manuscript is to be 
venerated us ins* MAE.- manuscript should be set and format 
clear”'<5MA SET, 3F0 CLEAR). Since the TED considers 
a blank line a deletion, you may insert a blank line 
by enter ins* a. line with a. s inale period. When printed, 
a. b lank l i ne w ill be output. 
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] MOVE x y z 

Move lines y thru z in the text f i le to just after line 
number x. The moved lines will all have line numbers 
eoiual to x. The original lines y thru z are deleted. 


]NUMBER x y 

Renumber the text file startins at line x in the text 
file arid exrand ins by constant y. For example > to 
renumber the entire text file by 10> enter ]NU 0 10. 


]OUTPUT fi le 

Create a. relocatable object file on disk. This command 
uses the 256 byte relocatable buffer that can be 
reallocated via the ]SET command. 


] PASS f i le 


Execute second pass of assembly. First pass must be 
previously performed. If file is entered then the 
text file is loaded before executins the second P'3 ss > 
else ]PASS will assume the file is in the text file. 


]PRINT 


•• f. 


'-I 


Print the 
on the CRT 
printed. 


text file data 
. If only x is 
If no x and y.- 


between line number x and y 
entered., only that line is 
the entire file is printed. 


3 PUT file x y 

Put text file between lines x and y to 
If x and y are not entered., the entire 
be rut to disk. 


d i sk. 

text file will 
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3 RUN label 


Run (execute) a previously assembled program. It a 
symbolic label is entered., the label tile is seat'd 
tor the startins address. The called program shoi 
contain an RTS instruction as the last executable 
instruction. 


] SET ts te Is li 


b 


.1 ■*, 


It no parameters are siven, the text tile., label tile., 
an d r e loo at afo 1 e b u 11 e r b o u n d ar i e s < ad d r e s s e s 
i n d i c at i n a t e x t tile s t ar• t.- e n d , 1 ab e 1 tile s t ar• t.- e n d.- 
and relocatable butter start) will be output on the 
tirst line. On the second line the output consists 
ot the present end ot data in the text and label tile, 
command is commonly used to determine how much memory 
is remainins in the text tile. It you are inputtins 
hex disits tor these addresses., preceed each with a. 
character. 

It parameters are entered, the tirst two are text ti le 
start (ts) and end (te) addresses.* then the label tile 
start (Is) and end (le) addresses., and ti rally the 
relocatable butter start address (bs). 


] TI w n 

fissisn terminal input (keyboard) as PET it w=PET.. or 
serial device it w=SERIAL. Both input and output will 
be assisned to the serial device it w-TERMIHfiL. 

It entered., n is the number ot pad bits to be sent on 
occ u r r anc e o t carr i ase ret urn . 

When ]TI SERIAL or DTI TERMINAL is entered, you must 
type S on the serial keyboard so MAE can determine 
the baud rate ot the device. Permissable baud rates 
are 110, 300, 600, 1200, 2400, 4800, 7200, and 9600. 
fitter you type S, press the return key. It MAE 
receives a. valid carria.se return character, control 
is then transterred to the serial device. It a. valid 
carriase return is not received, contro 1 will rema.in 
with the PET. 


3TO w n m 


fissisn terminal output 
PET it w=PET, IEEE devi 
it w=SERIfiL. It w=fiLL, 


( CRT 
ce #4 
then 


or printer) as : 
it w—IEEE, or serial 
output will be directed 
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to both the IEEE and the serial device. 

If urSERI fiL or ALL., then n is the baud rate code and 
m is the number of rad bits on occurrance of carriage 
return. The baud rate code vn } is as follows’ 


n 


0 

1 


U* 

3 


cr 

D 


O 

7 


baud rate 

» *mm mam mam mam amaa mam mm* mam mam « 

110 
300 
600 
1200 
2400 
4800 
7200 
9600 


] USER 

Restore zero rase and so to location $0000. Vou must- 
have entered a JMP instruction at that address. 
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ENTRV/BELET IGN/C 


3E OF TEXT 


Source is entered in the text ti le toy enterins a. line number 
<0-9999) followed by the text to be entered. The line number 
string can be one to n dibits in length. If the string is create 
than 4 dibits in length.- only the riaht-most 4 are considered. 
Text may be entered in any order but will be inserted in the text- 
file in numerical order. This provides for assembling.* printing., 
and recording in numerical order. Any entry consisting 
of a. line number with no text or -just sraces resu Its 
in a. deletion of any entry in the text file with the same 
number. If text is entered and a corresponding line number 
already exists in the text file., the text with the corresponding 
number is deleted and the entered text is inserted. 

To delete the entire file., use the 3CL command. 

To delete a. ranee of lines.- use the 3BE command. To edit an 
existing line or lines hawing simi lar characteristics., use the 
3EB command. 

To alter an existing line., use the 3ED command form 2. 


To find a. string., use the 3FI command 
use the 3MO or 3CO commands. 


To move or copy lines 


To insert a. blank line., enter a. line with just a. period <•>. 

Text may be entered more easily by use of the auto line 
numbering feature <3HU command). Any 3AU x where x does not 
actual 0 puts the TEB in the auto line number mode on the next 
entry of a. line number. To exit form this mode.■ type 3//. 

When entering source for the assembler., one need not space over 
to line up the various fields. Labels are entered immediately 
after the line number. Separate each source field_with one or 
more spaces. If the format feature is set (see 3F0 command); 
the TEB will automatically line up the fie Ids. Hote : If a 
space is entered before the label., the TED wi 11 line up the 
label in the next field. This shouId result in an assembler 
error when assembled. Commands., mnemonics.* and pseudo ops may 
be entered as upper case or lower case characters. Labels in 
the program may be entered as upper or lower case characters 
but a label entered as upper case will be unique to the same 
label entered as lower case. 


5. ASSEMBLER (ASSM) FEATURES 

The ASSM scans the source program in the text file. This rectuires¬ 
et least 2 passes (or scans). On the first pass., the ASSM 
generates a. label file (or symbol table) and outputs any errors 
that may occur. On the second pass.* the ASsM creates an 
optional listing. 

A third pass (via 3OLD., may be performed in order to generate a 



relocatable object -file of the program in the text file, 
file is recorded on disk and may be relocated at the uswt s 
descretion practically anywhere in memory. 


Thi 


fl. Source Statement syntax 

Each source statement consists, of 5 fields as described be low • 
] line number label mnemonic oner arid comment 


Labe l : 


The first character of a label may be formed from 
the following characters 1 
@ fl thru 2 L S 3 t *• 

While the remaining characters which form the label 
may be constructed from the above characters arid the 

following characters 1 
. / 0 thru 9 : ; < > V 

The label is always entered immediately after the line 
number. 


Mnemonic <or Pseudo Qp> : , ,, - . , 

The mnemonic or pseudo op is separated from the label 

nne or mere spaces and consists of a. standard 

6502 mnemonic of table fl.. rseudo op of table B, or macro name 


Operand * 


The operand is separated from the mnemonic or pseudo op 
one or more spaces and may cut is. i —* t of a labe l 
expression from table C and symbols which indicate 
the desired addressins mode from table D. 


Comment : 


The comment is separated from the operand field by one 
or more spaces and is free format, fl comment field 
h^in-" one or more spaces past the mnemonic or pseudo op 
if the nature of such does not require an operand field, 
fl free format comment field may foe entered if a 
semicolon <;> immediately follows the line number. 


NOTE: 


It is permissable to have a line with only a. Label. 
This is commonly done to assian two or more labels t« 
the same address. If the line has only a Label or 
label with comment.* then the label may be any length 
up to 79 characters resard less of the label lensth 
set with the ]FORMAT command. 
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TABLE B - Pseudo Ops 


.BA le.be 1 exp. 

Beeun assembly at the address calculated from the label 

exrr-e«>iu n. Thi- fj” r result %nd the assembly will halt 
&3SS or* 3i' i 0rr of uii 11 r j. «.* ** - 


.BV 

q+nr-p hMt.es ot data. Each hex, decimal, or binary byte 
" + u lP separated hy at least one space. Hn ascii striny 

ASM 'be'e^ered by besinnin«_and endina i»ith a»:strop!hes 
f; le ■■ .BV 00 •“ ABCD 47 t'J 'f *FL .-.llOl 


.CE 

Continue assembly it error 
occur. AH error messages 


■. other than !07, 
will be printed. 


! 04, and !17 


.CT 

Designate current contents ot text butter as a _control 
tile. Only one control tile may exist during 
assembly. Designation as a control tile allow* th* 
use ot .FI pseudo ops to link other tiles tor- the 

assembly process. 


Note : 


Only one .EN pseudo op is allowed in each 
as---embly and it .CT is used, the .EN must be 
at the end ot that tile. Thus, tiles referenced 
I,ia .FI must not have a. .EH pseudo op. 


label .BE label exp. 

Assian the address calculated trom the label expression 
to the label. Designate as external arid rut in the 
label tile. An error will result it the label 1-- 

amitt@cL 
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label .HI label ex*. 

Assign the address calculated from the label expression 
to the label. Designate as internal and rut in the 
label file. An error will result if the label is 
cmitted. 


.DS lafoe 1 ex* 


Define a block of storage. For exam* ie. if label ex*, 
equated to 4.- then ASSM will ski* over 4 bytes. 

Note : The initial contents of the block of storage 

is undefined. 


.EC 

Suppress output of macro generated object code on sourc 
listins. This is the default state. See part 5E. 


.EJ 

Eject to to* of next rase if 3HA SET was previously 
entered. 


.EN 


Indicates the end of the source program 


. Es 

Output macro generated object code on source listing. 
See part 5E. 


.FI file 

Assemble the specified file before continuing with 
statement fo 1 lowina .FI. 


Note : The .FI pseudo op is allowed only in the control 
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•file (that designated with ,CT>. 


.IN lab© 1 

Output ? followed with space arid 
4 hex disits. These hex disits 
to labe l and stored in the label 

Input will only occur on the fir 
The label must be symbolic and s 
similar to the follow ins example 


then accept exactly 
will be assisned 
fi le. 

st pass of assembly, 
hould be defined 


BEGIN.RUHR 





. PR 




.IN 

One 

ShiOU 

Id a 1 

-.-'o i d 

the 

labe 

1 as 

the 

spec 

if ie 

d va 

lue 


"ENTER ASSEMBLY 
BEGIH.hUDR 

us ins . BE .• .HI.- 
>e constructs re 
:m each p- ass • 


START" 

or SET to define 
ssisri their 



C lear the 1 i st- opt i on so that the 
print ins the source list ins after- 


assembly terminates 
the .LC on pass 2. 



Set the list option so that the 
out the source listins after the 


sernfoly besins printin 
LS on pass 2. 


.MC label exp. 


When storins object code., move code to the addres: 
calculated from the label expression but- -assemble 
relation to that specified by the .Bfi pseudo op. 
fin undefined address results in an immediate 
assemb ly ha It. 


m 



Macro definition. See part 5E. 
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.ME 

Macro end of definition. See part 5E 


. MG 

.MG declares the entire contents of the text file as 
M ac r o G1 o to a. 1. W h e n as s e m to 1 i n a f r o m d i s k .• a 11 
following files will toe loaded into the text file area, 
following the file with the .MU. Thus.- even thou eh 
there can be many modules loaded and assembled.- the 
macro aloha l file is 11 locked" into the text file area, 
rrooidina its macro definitions for use by a. 11 
subsequent fi les. 


.OC 

Clear the object store option so that object code after 
.OC is not stored in memory. This is the default option 


• OS 

Set the object store option so that object code after 
the .OS is stored in memory on pass k!. 


.PR "text" 

Output the text that is enclosed in quotes when the 
.PR is encountered. MfiE automa.tica.lly issues a. 
carria.ee return immediately before outputtina the text. 
The text will be output only durina the first pass 
of the assembly. 


.RC 

Provide directive to the relocating loader to stop 
reso Ivina address information in the object code 
per relocation requirements arid store code at the 
pre-re located address. This condition remains in 
effect unti 1 a .RS pseudo op is encountered. 
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Provide 
address 
and stor 
This is 


directive to the relocating loader 
information in the object code per 
e the code at the proper re located 
the default condition. 


to reso Ive 
re location.* 
address. 



label exp. 


Store the a<: 
in the next 
as beinn an 
assigned to 


4dress calculated from the label 
tvjo memory locations. Consider 
external address. Note : If a 
the .SE.. it will be considered 


expression 
this address 
label is 
as internal. 



label exp. 


Store the 
in the ne 
as foeinn 


address calculated from 
xt two memory locations, 
an internal address. 


the label expression 
Consider this address 





TABLE C 
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Labe 1 Express i on: 


A 1 abe 1 ex p ress i on must not cons i s t of ernbedded s p a.ces artd i s 

c o n s t r u c fed f r o rn the f o 11 o uj i n a : 

Symbo lie Labe 1 s : 

0 n e t o 3 i c h ar a.c t e r s c o n s i s t i n a o f the as o i i c h bp a.c t e r s 
as p r e w i o u s 1 y d e f i n e d * T h e rn ax i rn u rn n u rn b e r o f c b ar - ac t e r s 
set by the ]FORMAT SET n command where n — the maximum 
number allowed. The default maximum is 10 characters per 

N o n - S y rn b o lie L ab e 1 s : 

I) e c i rn a 1.« h e x.« o r b i n ar y u a. 1 u e s rn ay b e e n t e r e d * If n o 
s p ec i a. 1 syrnbo 1 p receeds the nurnera. Is then the AobM assurne 


i 4 7 *> 

a* i t 


$F3>. 


decimal (e x am p 1 0 : 147). I f $ p r e c e e d s .• 'than hex is 
assumed (example 1 $F3). It “» proceeds.. then binary is 
assumed (example 1 %ilQ81). Leadins zeros need not be 
entered. It the decimal or hex strins is areater than 
4 d is its.' o n 1 y the r i a h t m o s t 4 ar e c o n s i d e r e d. 

It the binary strina is ar eater than 8.- only the 
riahtmost 8 are considered. 


laJc 


F' roar am Fount er • 

To indicate the current- 
use the symbol =. 


'.ocat i on 


t h e p r o a r a 1 » c o u n ter .> 


Arithmetic 0p e r ators : 

These are used to separate the above labe 
elements. Two operators are reconized ; 

+ addition 
subtraction 


el expression 


E x am p 1 e s o t s o m e v a. lid 
LDft #X1181 
ST A tTEMP+fOi 
LDA C471E36 
JMP L00P+C-$461 
BHE =+8 


1 abe 1 ex p ressions tollow ; 

LOAD IMMEDIATE $0D 
;STORE AT EVTE FOLLOWING TEMP 
;LOAD FROM LOCATION $1E36 
JMP TO CALCULATED ADDRESS 
BRANCH TO CURRENT PC PLUS 8 BV 


One special label expression is A.- as in ASL A. I he Letter A 
to 1 lowed with a space in the operand field indicates 
accumulator address in-a mode. Thus LDA A is an error condition 
since this addressing mode is not valid for the LDA mnemonic. 

ASL A+Q does not result in accumulator address in-a but instead 
references a memory location. 
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B. Label File (or Symbol Table) 

A label -file is constructed by the assembler and may be outputted 
At the end of assembly (if a .LC pseudo op was not encountered) 
nr Si the 3LA command. The output consists of the symbolic 
label and its hex address. Via. the 3LA command, the user may 
select which typ*e of labels to be output. 3 LA FI .•■■.ED uutpu .-s 
all program and internal labels, and 3LA ALL outputs all labels. 

When a. re locatab le object file is aenerated via. 3UU comm cmd, 
any instruction which referenced an internal label or e. label 
expression which consisted of at least we i t - iter na.l label wi l 
be tagged with special information within the relocatable 
object file. The relocating loader uses this information to 
determine if an address needs to be resolved when the program 
is moved to another part of memory. 

f;r,nversely, instructions which referenced an external label 
or a" label expression consisting of all external references 
mill not be altered by the relocating loader. 


At the end of the label file the number of errors which 
occurred and program break in the assembly will be out pi 
in the following format-' //xxxx, yyyy,zzzz 


jtted 


Where xxxx is the number of errors found in decimal 
representation, yyyy is last address in relation tv 
and zzzz is last address in relation to .ML. 


BA, 


C. Assembling 


Source for a. large program may be divided intv modules-, 
entered into the text file one at a. time and reuurded 3 r _ 


on 


disk 


The^e modules can be linked together during -assembly via a 
control file. If used, the control file must be the first file 
to bo assembled. This file must be in the text buffer when the 
3AS command is issued, or its name must be specified in the JHo 
command (examr le: 3AS 11 MEM.TEST"). Fi les are 11 nked together 
via the .FI pseudo op. For example, to assemble d fi le:* named 
X..M61, V.M02, and Z.M03, we need to generate a contro l file say 
M.CTL (note for convenience we use the convention of tagging L-rL 
on the end of any name which references a control f i .e whi Le l .s- 
modules"are tagged Mxx). The file M.CTL may contain the following• 


f*T 

f i ns 

"K.M01" 

FI D8 

" V. M02 11 

FI D8 

“Z.M03" 

EH 



Now, when the control file is assemhled 
the files in the order specified. 


MAE is to Id to go assemb le 




ftt assembly * -the assembler cart load arid assemble each module unti l 
■the entire program has been assembled. This will re«tuire two pass _ 
f,-,r s complete assembly. When the end ot a. pass is encountered > MAE 
will output "the message END MAE PASS!. If for some reason you 
terminate the assembly on the second pass^ you may restart at the 
beginning of the second pass usins the 3PASS command. 


Ii. Creatin*i a. relocatable object file <3GU> 

In order to create a relocatable object file., the programmer should 
identify those labels whose addresses are fixed arid should not be 
altered by the relocating loader. This is done_yia the .BE 
pseudo op. Non—symbolic labels example• $0169) are also 

considered as beina external <or fixed). All other labels 
l includin'* those defined Mia the . DI pseudo op) are considered as 
internal. Addresses associated with internal labels can be altered 
by an offset when the program is loaded via the relocating loader. 

Also., the .SE stores a two byte external address and the .SI 
stores a two byte internal address. Simi lari ly the relocating 
loader will alter the internal address and not the external 
address. 

An example of an external address would be the calls to PET ROM 
routines or any location whose address remains the same no matter 
where the program is located. Expressions consisting of internal 
and externa. I labe Is wi 11 be comb i ned and uun^idtfi'tfd ^i inter na. I 
address. A label expression consisting entirely of external labels 
will be combined and considered as external. 

The relocating loader can relocate your program in 3 segments : 

Zero page var iables ^C internal addresses in range $00-$FF )> absolute 
variables C internal addresses in range $0400 — $iFFF.■ and pi 'u?f am 
body <references in range $2000 — $FFFF). To generate a re locatab le 
object fi le.. first partition your program into internal and 
external references. Remember., external references are those 
locations that are fixed while internal references are those 
locations which can be altered by the relocating loader. 

Start assigning zero page references at location $0U0@.> absolute 
vaniable locations at $U4UU.> -arid begin assembly of the program at 
$2000. Next assemble the program via 3AS., and then issue the 
3OUT command to generate a. relocatable object file. 

Now.* we have the relocatable object code on disk. To load this 
object code back into memory.- first load the relocating loader. 

The relocating loader is contained on the diskette with the name 
RELOC.EXE. Execution begins at $500 if in the monitor or SYS 1280 
if in Basic. The relocating loader will reoiuest the following : 

1 ) FILENAME? Name of the file containing the relocatable object 
- code. 

2) Z-PG OFFSET? Address to begin assignment of zero page internal 
- references. 

3) ABS OFFSET? Address to begin assignment of absolute internal 






FHbE io 

- references. 

4> PGM EXE OFFSET? Address the proaram is to execute. 

5 ) pgm STORE OFFSET? Address to store the program object code 


When the file has been relocated in memory.- it can be saved on disk 
< us ins Ex train on > as an executable file.- which may be reloaded w i tho< 
usins the relocating loader. 

As an example.- lets assume we want to relocate a pr oar am named 
IJHRT to execute at location $3860.- but store the_object code at 
$1080.- and start the zero rase variables at $8060.- and the absolute 
variables at $4000. We would respond to the relocating loader as. 
fo 1 lows : 

FI LEHAME? D8 " 1 : UART. REL 11 e Fi le name 

7 -pQ OFFSET? $60 e Ass ian start of zero rase var. 

ABS OFFSET? $4000 e Ass ian start of absolute var. 

PGM EXE OFFSET? $3080 e proaram body start 

PGM STORE OFFSET? $1008 e Store of code start 


LOAD MAP 


e R. L. outputs a load mar- 


FILENAME? 


e Enter just return to exit the 
Relocatina Loader 
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E. Macros 

MAE provides a macro capability. A macro is essentially a 
fa.ci lity in which one line ot source code can represent a -function 
consisting of many instruction sequences. For example.- the 6582 
instruction set does not have an instruction to increment a double 
byte memory location. A macro could be written to perform this 
operation and represented as INCB (VALUE.1). This macro would 
•appear in your -assembly lansua.se list ins in the mnemonic field 
similar to the following 

SHE SKIP 
NOP 


INCH (VALUE.1) 
LBA TEMP 


; INCREMENT BOUBLE 


Before a macro can be used.- it must be defined 
to process it. H macro is defined via the .MB 
pseudo op. Its form is : 


in order for ASSM 
<macro definition> 


! ! ! labe l 


MB (Li L2 ... Ln> 


Where label is the name of the macro (!!! must preceed the label).- 
and LI.- L2.- ...... Ln are dummy variables used for replacement with 

the expansion variables. These variables should be separated usins 
spaces.- do not use commas. 

To terminate the definition of a. macro> use the .ME (macro end 
pseudo op). 

For example.- the definition of the INCB (increment double byte) 
macro cou Id be as fo l lows •' 


! !!INCB 


SKIP 


. MB 
INC 
BNE 
I NC 
.ME 


(LOC) 

LOC 

SKIP 

LOC+1 


.: INCREMENT BOUBLE 


This is a. possible definition for INCB. The assembler will not 
produce object code until there is a call for expansion. 


Note 


A call for expansion occurs when you enter the macro 
name aIons with its parameters in the mnemonic field as 
INCB (TEMP) or INCB (COUNT) or INCB (COUNT+2) 
or any other labels or expressions you may choose. 


Note 


In the expansion of INCB.- code is not be ins senerated 
which increments the variable LOC but instead code for the 
associated variable in the call for expansion. 


If you tried to expand INCB as described above more than once/ 









r 


O tr 

x. i 


you will yet- a !U6 error message, 
error arid it would result because ot the label SKI 
in the first expansion and asain in the second exp 


This is a. duplicate ie. 

occurri r 

~ i on. 


’»«* *0 « *8** 


There is a way to yet arround this and it has to do with makins 
the label SKIP appear unique with each expansion. This is 
accomplished by rewriting the I NCD macro as to 1 lows : 


! ! ! INCH 


.. SKIP 


.mu 

(LOO 

INC 

LOG 

BNE 

...SKIP 

I NC 

LOC+1 

.ME 



; INCREMENT DOUBLE 


substituted for SKIP. What t 
expansion a unique macro 


The only difference is ...SKIP is 
ftSSM does is to assian each macro 
sectuence number <2't't 16 maximum macres in each file). If the 
label bey ins with ... then ftSSM will ass i y n the macro sequence 
nurnber to the 1 abel. Thus.• since ea.ch ex p ansion of this macro 
yets a unique sequence number., the labels will be unique and 
the !06 error will not occur. 

If the label ...SKIP also occurred in another macro definition., 
no !86 error will occur in its expansion if they are not nested. 

If you nest macros (i. e. one macro expands another)., you may 
yet a !06 error if each definition uses the ...SKIP label. 

The reason this may occur is that as one macro expands another 
in a nest.* they each -yet sequentially assiyned macro sequence 
numbers, fls the macros work out of the nest.- the macro sequence 
numbers are decremented unti 1 the top of the nest. Then as futher 
macros are expanded., the sequence numbers are asain incremented. 
The end resu It is that it is poss ib le for a. nested macro to 
have the sane sequence number as one not nested or one at a 
different level in another nest. Therefore., if you nest macros., 
it is suyyested that you use different labels in each macro 
definition. 

Some futher notes on macros are : 

1) The macro definition must occur before the expansion. 






The macro definition must occur in each file that 
references it. Each file is assiyned a unique file 
sequence number £2##16 maximum files in each assembly) 
which is assiyned to each macro name. Thus the same 
macro can appear in more than one file without 
causiny a !06 error. If a macro with the same name 
is defined twice in the same file., then the !06 error 
will occur. 

Macros may be nested up to 32 levels. This is a 
limitation because there is only so much memory left 
for use in the stack. 


4) If a. macro has more than one parameter., the parameter: 
should be separated usins spaces - do not use commas. 


5) The number of dummy parameters in the macro definition 











PAGE 26 


fc. .> 


must match exactly the number of parameters in the call 
tor expansion. 

The dummy parameters in the macro detinition must be 
symbolic labels. The parameters in the expansion may 
be symbo l ic or non—symbolic labe l expressions. 

It the . ES pseudo op is entered.- object code -generated 
by the macro expansion will be output in the source 
listing. Also.- comment lines within the mact- u 
detinition will be output as blank lines duriu-g 
expansion. Conversely, it .EC was entered, only the 
line which contained the macro call will be output 
in the source listing. 


3 > 3 macro name may not be the same as a 6582 mnemonic, 

pseudo op, or conditional assembly operator. 


F. Conditional Assembly 

MAE also provides a conditional assembly facility to uonditiohe. I la 
direct the assembler to assemble certain portions ot your- 
program and not other portions. For example, assume you have 
written a CRT controller program which can provide either 
.=, 40 , 64, or 88 character per line display. Instead of having 
to keep 3 different conies of the program, you could use the 
ASSM conditional assembly feature to assemble code concerned 
with one of the character densities. 

Before we continue with this example, lets describe the 
Conditional Assembly operators : 


IFE label exp. 

If the label expression equates to a 
assemble to end of control block. 


zero '-tu entity, then 


IFH label exr. 

If the label expression equates to a oiuantity not e^iual 
to zero, then assemble to end of control block. 


IFP label exr. 

If the labe l expression equates to a positive oiuantity 
or 0088, then assemble to end of control block. 











PAGE 


IFM label exp. 

It the label express ion e-tuates to a. negative m i r ius 
ctuantity.. then assembly to end of control block. 


T h r e e aster is k s i n t h e m n e rn o n i c t i e 1 d i n d i c at 
of the control block. 


es the end 


SET labe 1= labe 1 exp. 

Set the previously detined label to th 
calculated from the label expression. 


e quantity 


NOTE : fill labe 1 expressions are equated usins IS - bit 

prec i s i on ar i thrnet i c. 


Go i na back to the CRT controller sottiuare example.* a poss i b l< 
arrangement of the program is as to 1 lows : 


CHAR.LINE 


. DE 48 


IFE CHAR.LINE-48 

CODE FOLLOWS FOR 46 CHARACTER PER LINE 


IFE CHAR.LINE-64 

;CODE FOLLOWS FOR 64 CHARACTER PER LINE 


•T- ♦T* 


IFE CHAR.LINE-88 

CODE FOLLOWS FOR 80 CHARACTER PER LINE 


; COMMON CODE FOR ALL 


PAGE 


oo 

y ts 

k» W 


Shown is the arrangement which wouId_assemble code associated 
inith 40 characters per line since lHAR.LINE is- detined <*=• 
e , :tua i 40 . i-f you wanted to assemble tor SU characters, 

simply detine LHARl.LINE as e*-tua.I o0« 

f: n ri d i t i o n a l as s e m b l y c an a Iso b e i n c o f • p u r at e d w i t h i f i m y-- f 


lata. It could be detined as tulluws- 


EXPAND 
!!!SORT 


. DE 0 
. MD 

IFN EXPAND 
JSR SORT.CALL 


;CALL SORT 


IFE 

JSR 

JMP 


EXPAND 
SORT.CALL 
. ..ABC 


;SORT CODE FOLLOWS 
SORT.CALL 


RTS 

.ABC SET EXPAND^1 


ME 


In this example, EXPAND is initially set to 0._ When the_macro 
is expanded tor the tirst time, EXPAND e*iuals_y -and the cud* 
s.4. cnpT rnLL ini 1 1 hp assemfoled a.lorry wi*th a. Ji*R "bo arid a. JMF 

around the sort subroutine. Also, the tirst expansion sets _ 

E w PflHD +.n 1. fin each suceedina expansion.* only a. JoR ihs>“bruu ,iut\ 
mill be'assembled since EXPAND equals 1. Usin* conditional 
assembly in this example resulted in more efticient^memory 
utilization over an equivalent macro expansion without 

cond i t i ona. I assemb ly. 
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G. Interactive Assembly 

Interactive assembly is a new concert in which the assembler 
can be instructed to print messages and/or accent keyboard 
input during the first pass of the assembly. 

Interactive assembly makes use of two pseudo ops : 

.PR to print messages 
. IN to accent keyboard input 

An example of the use of interactive assembly is as follows 1 


ADDR 


PR "INPUT START OF ASSEMBLY" 

IN ADDR 
BA ADDR 


Note that in this example.- the assembler will request entry of 
an address to be assigned to ADDR.- and then be a i ns assembly 
at that address. 

There are many applications for interactive assemb ly but 
those possibi lities are left for the users of MAE. 


NOTE: 


Never specify a label as the operand in the .IN 
pseudo op that has been defined by the .DE.- . BI, 
or SET pseudo ops. The reason is that these 
pseudo ops initialize the address assigned to 
associated labels on both -assembly passes while 
all other labels are initialized only on the first 
pass. Since the .IN pseudo op accents input on 
the first pass only.- usa.se of labe Is defined by 
.BE, .DI, and SET will cause different label 
values on pass 1 versus pass 2. 


H. Befaw It Parameters on entry to ASSM 

Boes not store object code in memory (otherwise use . US) 
Beains assembly at $0486 (otherwise use .BA) 

Halts assembly on errors (otherwise use .CE) 

Stores object code beginning at $0400 unless a. .BA or .Mu 
is encountered and if .OS is present. 

Object code separated by macros does not appear on the 
assembly listins (i.e. defauIt is .EC> 


6. RELOCATING THE RELOCATING LOABER 

A relocatable object file of the relocating loader i 
on the diskette with the name RELOC.REL. 


s contained 
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To re locate "the re loo-set i ns loader .• load "the executab le copy 
(RELOC.EXE) arid bey in execution. When FILE NAME? is output, 
enter "RELOC.REL". Then enter 0 for Z-PG OFFSET? and 0 for 
ABS OFFSET?. Finally.- enter the address of the location 
you want the relocating loader to execute and reside for 
PGM EXE OFFSET?, and PGM STORE OFFSET?. 

When the re locator completes its task, you may save an 
executab le co p y on disk usina the PET monitor. Just 
remember, execution bea i ns at the address specified for the 
PGM EXE OFFSET - not $0500 as for the executable copy suppli 

(. RE LOG. EXE) . 
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7. ERROR CODES 


An error message of 
error code end yyyy 


the 
it en 


the -form ! xx AT LINE yyyy where xx i: 
is the line number will be outrutted 
error occurs. Sometimes en error message will outrut an 
invalid line number. This occurs when the error is on a 
non - existent line such as en illegal command inrut. 

The to 1lowing is a list ot error codes not srecitically related 
to macros• 


ERROR CODE 

IB 

1A 

19 

18 

17 

16 

15 

14 


13 

12 

11 

10 


0F 

0E 

0D 

0C 

0B 

0A 

09 

08 

07 

06 

05 

04 

03 

02 

01 

08 

ED 


DESCRIPTION 


: ists. 


.EN in non .CT tile when .CT tile e> 
.EN missins in .CT designated tile. 
Found .FI in non .CT tile. 

Checksum error on disk load. 


Syntax error in ]ED commend. 

Device numbers 8.• 1 .>2.• 3 not allowed. 

Multirle .CT assignment. 

Command syntax error or out ot range error. 
Missing parameter in 3NU command. 

Overt low in line # renumbering. 

CAUTION 1 Vou should rrorerly renumber the 
the text ti le tor proper command operation. 
Overt low in text tile - line not inserted. 
Overt low in label tile - label not inserted 
MAE expected hex characters.- tound none. 

II lega 1 char acter i n labe 1. 

Unimp lemented addressing mode. 

Error in or no operand. 

Found i 1 lega 1 character in decimal string. 
IJndetined labe 1 (may be illegal labels. 

.EN pseudo op missing. 

Dup 1icate labe 1. 

Label missing in .BE or . BI pseudo op. 

.BA or .MC operand undetined. 

III e g a 1 p s e u d o o p . 

Illega1 mnemonic or undetined macro. 

Branch out ot range. 

Not a zero page address. 

Error in command input. 


The to 1 lowing is a list ot error codes that are specitie-ally 
related to macros arid condition assembly: 


ERROR CODE 

2F 

2E 


DESCRIPTION 


Overt low in tile se-nuance count (.2## 16 max .) 
Overt low in number ot macros 16 max .) 












.1 SI 


KJ 





ci'd 


JJ 

&*» 
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.ME without associated_.MD 

Non-symbolie label in GET pseudo op. 

Illegal nested definition. 


Macro definition overlap's file boundary. 

Dup 1icate macro definition. 

Quantity parms mismatch or illegal characters. 
Too many nested macros 032 max .) 

Macro definition not complete at .EN 
Conditional suppress set at .EN 
Macro in expand state at 




ed expansion 


.EH 

ore definition 


i a 
KJ u 


STRING SEARCH AND REPLACE COMMANDS 


A. Edit Command 

A pmuerful string search arid repla.ee.- and line edit capability 
is provided via the ]EDIT command to easily make changes in the 
text file. Use form 1 to string search and rep lace > and form 2 

t o edit a particu1 ar line. 

F or m 1 


DEBIT tSltS2t YA 


# 




Where : t 


«s» t 

si 




d 




# 




y 


is 
i s 
i ^ 
is 


y 
* « 


a non-numeric.. non-SPace terminator 
the string to search for 
the string to replace Si 
don't care character. Proceed with 
character to change the don't care., else 
don' t care character w ill be % by def au It. 
indicates to interact with user via 
subcommands before re p lacing S1 
indicates to alter but provide no printout 
Note : No # or # indicates to alter and 

provide printout. 

1ine number start in text f i le 
line number end in text fi le 


Asteri 
A 
D 
M 


V 


sk <#> prompter subcommands : 
a Iter fie Id accordingly 
de lete entire line 

move to next fie Id - don't alter current 
skip line - don't a Iter- 
ex it 3ED command 
enter form 


» 2 


DefauIts 


d 


V 


y 


at 

t'm 


0 

qqqq 


• 0 


I f no : 

f or # i 

lines 

aItered 


all 
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• # * t 


For examp le .> "to rep lace 3 .11 occurances of the labe 1 LuuP with 
the label START between lines 188 and 680.• enter : 

DEBIT ,•■'LOOP,-'START,188 688 

« 

To simply delete all occurances of LOOP., enter : 

]EDIT /LOOP// 188 688 

Vou may use the t arid # as described above. 

The slash ("/") was used in the above examples as the terminet 
but any non-numeric character may be used. 

At the end of the DEBIT operation., the number of occur ances of 
the string will be output as //xxxx where xxxx is a. decimal 

ciuant i ty. 


Form 2 

DEBIT n 

Where : n is the line number (8-9999) of the line to 

be edited. 

After executing the command.- cursor over to the part to be 
charmed.• and either type over or use the INs/DEL key on the 
PET just as you would use the screen editor. Press RETURN 
when done.- and MAE wi 11 insert it in the text file. 


B. Find Command 

If you want to just find certain occurances of a particular 
strins.* use the DFINB command. Its form is- 


3FIND tSlt # 


v « 


Where : t.. SI.. #.. x.. and y are as defined in EBIT command 

For example.. 3FINB /LB A/ will output all occur ances of 
the strins LBA in the text file. 

At the end of the 3FINB operation., the number of occur ances 
of the strins will be output as //xxxx where xxxx is a 
decimal .quantity. 

A unique use of this command is to count the number of 
characters in the text file (excluding line numbers). The 
form for this is : 3FINB /'■;/# 
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9, CONTROL CODES (Serial Device) 


The following applies to the optional serial device connected to the 
PET. flscii characters whose hex values- are between hex 00 arid «:0 are 
norma 1V-* non-print ins characters. With a. tew except i ons , the^e 
nharaoters will be output in the following manner' Tc where 
c is the associated printable character if hex 4U was added 
to its value. For ex amp le, ascii 03 wi 11 be output as 1C., 
and 18 as TXetc. 

; have special functions 


n addition 
in MfiE. 


;or,ie of these contro i cc.. 


Control codes which have special functions are 


•#* utu m&v* 

UDE 


DESCRIPTION 


T@ 

TB 


TO 

TH 

tl 

TJ 

tt-1 

to 


TX 

tv 


-7 




,411 (hex 00) 

Restore zero page and go to Basic 
Restore zero page and go to Monitor 
Bell 

Backspace <de lete previously entered char 
Horizontal tab to next 8-th char, position 
Line feed 
Carriage return 

Continue processing but no output (same as DEL.-* 
Continue after stop via break key 
De lete entrire line altered 

Restore zero page and -jump to location # 0000 . 
(you may reenter at $5803) 

Terminate processing -and go to 11 1 11 level 
Escape character 

f = Non-printing contro 1 char ac ter. 


3. CONNECTION OF fl SERIAL DEVICE 

A serial device may be connected to your PET and contro 1 led by 
MAE "software. MAE generates data, in TTV (or R3232) data, 
format on the USER port (bit 7 p*in L — output., 
bit 6 pin K = input). The data format consists of one start.- 
■^.’.pr, data... and two stop bits. Since these signals on the 
user port are TTL levels, circuitry may be required to 
provide a proP*er electrical interface. We have found, though, 
that RS232 terminals such as the Synertek KTM-80 can be 
connected directly to the user port. If you do provide 
interface circuitry, you should not invert the signals as they 
are in positive true state. 

The commands 3TI and ]T0 are provided to direct MAE to 
input or output on this serial port. 
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11. EXAMPLES 
A. TED Examples 


#1 Illustrate to ways to load MAE using MAE/DOS 
and begin execution at cold start. 

/MAE.EXE# or AC 

U S 29480 


support 


#2 Illustrate two ways to load and initialize the extend 
monitor (EXTRflMDN>. 

/EXTRAMON.EXE or MC 

SVS 4096 


#3 Illustrate entry of text. 

3AUTO 10 

31000;THIS IS A TEST 
1010LGOP LDA VALUE,V 
1020 NOP 
1030END.PGM .EN 
1040// 4-Note, 


enter // to exit- 
auto line #-ing 


#4 


Illustrate listing ot text. 

3 PRINT 

1000 i THIS IS A TEST 

1010 LOOP LDA VALUE,V 

1020 NOP 

1030 END.PGM .EN 


// 


#5 Put f i le to disk (device 9, drive 0) with name TEST 

3PUT D9 "0 ; TEST" 

#6 Get tile trom disk (device 8, drive i> named TEST. 

3GET "0 : TEST" 

Note : The default is device 8. 

#7 Assemble file CRTDVR and generate a listing. 

3ASSM "CRTDVR" LIST 


#8 Output directory for drive 0 

3DC "*°" 


#9 Scratch file TEST. 

3DC "S : TEST" 

#10 Read disk error channel. 

3 DC 

#11 Direct output to IEEE printer (device #4> 

3TO IEEE 


#12 Direct output to Serial device at 300 baud with 
10 Pad bits. 
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3TO SERIAL 1 10 

#13 Ass inn sen is. I device as input ( keyboard) end 
out nut (with 2 pad bits.). 

]TI TERMINAL 2 


#15 


b 


user - types S on sen i a. I keyboard then 
types RETURN. 


Find all occurrences ot the text LBA. 

3 FIND /LBA/ 

Replace all occurences ot LBA FA with LBA #FA 
between lines 1000 end 280U. 

3EBIT /LBA FA/LBA *FA/ 1000 2000 


#16 Provide tor 15 characters per label. 

_ 3FORMAT SET 15 

#17 Output all tixed <external) labels. 

3LABELS FIXEB 

#18 Renumber the text tile beninninn at line number 180 
and incrementinn by 5. 

3NUMBER 100 5 

#19 Move lines 100 thru 280 to atter line 9888 

3MOVE 9800 100 280 

#20 Print lines 908 thru 976 

3PRINT 908 976 

#21 Reallocate the text tile to $408 thru $1FFC 

3SET $400 $1FFC 


yj 


Go to Basic. 
3BASIC 


return via SVS 20480 (co Id start 

or SVS 20483 (warm start 


23 Go to Machine Lannuane Monitor. 

3BREAK return via G 5000 (cold start.) 

or G 5003 (warm start) 


#24 Run assembly pronram at symbolic label BOX. 

3RUN BOX 

25 Channe trom Uppercase/Graphics character set to 
Lowercase/Uppercase or vice versa. 

3ALPHA 


B. ASSM Examples 

#1 Benin assembly at $1808 and 

.BA $1800 
. OS 


store object code 
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#2 


Begin assembly at $1000 but store ob 
. Bfl $1000 
.MG $4000 


•ject code at $4000 


• US 


#3 Betine the CRT output routine 

CRT .BE $FFB2 


#4 Assign an internal work location in zero pane 

WORK .BI $0 


#5 Allocate 6 bytes ot storage. 

TABLE .BS 6 

#6 Betine labe 1 EOI as mask with bit 6 set and show us< 
in ANB statement. 

EOI .BE X01000000 

ANB #EOI 


#7 Load the low address part ot the 
and hiah part in register V. 

LBX #L,VALUES 
LBV #H,VALUES 


label VALUES in register X 


#8 Give example ot .BV pseudo op. 

.BV -ALARM CONBITION ON MOTOR 1" 


#9 


#10 


$0B $8A 


Store the address ot the internal label TABLE and 
the external labe 1 F'ETOUT. 

.SI TABLE 
.SE PETOUT 

Betine the contents ot the text tile as Macro Global 
so its macro detinitions can be used by subsequent 
tiles in the assembly. 

. MG 


NOTE: 


This locks the macro detinitions in the text 
butter. It you get a !0F error on subsequent 
loads.- you should know that you have overt lowed 
the text butter. The solution is to allocate 
more memory <via 3SET command) and then 
reaSsemfole. 


#11 


#12 


Show example ot a. very long label. 

MEMORY.TEST.FOR.6502 

JMP MEMORY.TEST.FOR.6502 

N0TE : Long labels <greater than that specified via 

3F0 command) are a. 1 lowed if defined on a. 
line with no mnemonics. 


Reference the call to the PET RBT ascii 
so the relocating loader will not alter 
during loading. 

RBT .BE $FFCF 


the 


acter routine 
address 
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JSR RDT 




$FFCF 


12 . 


GETTING STARTED WITH MAE 


An extended monitor program (EXTRAMON) is contained on the 
supplied diskette. This pro a ram .• developed toy Bill Seiler 
of CBM.* provides many additional monitor commands which will 
be of tremendous help in your program development at the 
object code level. Therefore.* we recommend that you_ load 
EXTRAMON with MAE. If you are unfami lar with EXTRAMON.* 
load the Basic rroaram EXTRAMON.INS for an interactive review 
of its many powerful commands. 

Load MAE/DOS/ MAE/ and EXTRAMON as follows 1 






O' 


4- 

5- 
6 ' 


Insert supplied diskette in disk drive 8 
Load MAE/DOS support program via. LOAD "*"/8 
Type RUN to initialize DOS support pro-a ram. 

Note that the screen provides a description of 6 additional 
DOS commands : ACL AW/ MC/ MW.* LC.* LW. 

These commands are aids to ciuickly load and transfer 
control to other MAE prosrams. 

Type MC to load and initialize the extended monitor. 

Type .X to return to BASIC. 

Type AC to load arid cold start the MAE Assemtoler/Text Editor- 
will respond with : 


C 1979 BV C MOSER 


3808-4FFC 1888-2FFC 

3000 1800 


7800 


] 


This displays the default allocations of memory for the text 
file <3000-4FFC>.* label file a800-2FFC>.* arid start address 
of the 256 byte relocatable buffer <7800). On the next line/ the 
current end of the text file and label tile are displayed. 

Since they are initially cleared/ these are the sarnie as the ir¬ 
respective start addresses. Vou should note that the current 
end will ohan-ae as you insert/delete data, in the text file 
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and label -file. The 3SET command can be used to display 
this rarise a.sa.in or alter the tile buufidai■ i e^-. 

Remember, to exit MAE.> issue either the 3BAbIL or 3BREAK 
commands to so to Basic or to Monitor, tou may reenter- MhE 
via $5003 < warm start - everyth ins preserved; 1 or $->G00 
(no Id start - everyth ins cleared to default stated. 

It you are in BASICS type AW to warm start MhE. This is the 

as I6 5003 and SVS 20483. 

Also, you should note that EXTRftMON occupies memory 
at $1000-$17FF -and MAE occupies $5WW0-$77FF. ExTRHMuH also 
sets the Basic variable HIMEM to $1000 to indicate the end 
ot memory available tor Basics use. This- in^ettei.-.• pm_i ,ei- 
E‘x'TRAMfiH. MAE- and other prosrams above $1000 from be ms 
"clobbered" by Basic. Vou will want to manually reset 
HIMEM it Basic issues an out ot memory errur. Hi.ihfi ma¬ 
ke. reset to its cold start value as folium*- 


same 


ADDRESS 


DATA 


$0034 

$8035 


$80 


The -first thins you should do now is to load the MAE.MuT file via 
’]GET""MAE.NOT" 

]FORMAT CLEAR *- turn formattins off 

]Pll_ e enter upper/ lower case mode 

The MAE.HOT tile will contain any pertinent information pertaininy 
to MAE that was discovered after this manual was printed. 

Please review the information in this file. 

Now man should start playins arround with MAE by executing 
ite commands and then proceed ins to enter ms prosrams. 

Try reviewins the commands in part 4, assembler feature* in 
part 5, arid then the examples in part 10. 

We hope you find MAE to be an excellent prosram development 
aid and a worthwhile investment. Harry Hssemblins!!! 
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13. MAE S i mi* l i fied Text Processor ( STP > 

The MAE Simplified Text Processor (STP) is a word processor 
program designed specifically to work with the MAE text 
editor. The primary purpose of this word processor was 
to provide a simplified means to process program documentation 
and for other text processing needs. This simplicity was 
accomplished with a set of 16 easi ly remembered word processina 
functions.- and usaae of an already fami liar text editor to 
enter arid edit the raw text. 

STP.- unlike the CBM Word Pro programs* can output the formatted 
+i=->:'t t.n the screen. This is most useful on Sd column displays 
and can result in a tremendous savings in time .arid paper. 

To instruct the word processor to perform a word processing 
function.- one inserts text macros in the text to be formatted. 

A text macro always be a ins with a. period (. .- always bey ins 
in column 1.- may be entered as upper or lower case > and may 
or may not have associated parameters. The following are the 
macros provided by the STP word processor : 


VERTICAL SPACING .(.vsrace n> 

This macro is used to provide sinale.- double.- triple 
spacina.- etc. for the entire output. Enter the macro as shown 
above with the desired spacina. For example.- to request a double 
spaced output.- enter .vspa.ce 2. 


TEMPORARY INDENT (.sn) 


To indent n spaces on the next line.- use the 
n = the number of spaces to indent. For example.- 
the next line 5 spaces from the riaht. 


.sn macro where 
.s5 will indent 


MARGIN CONTROL (.m 


n p -h r) 


The marains default to 66 lines per paae.- left marain beains at 
column 0.- print width = 76 characters per line.- and the number 
of blank lines between text body and each title and footer = 


3. 


The parameters in the marain macro are : 

n = left marain beain position (default = @) 

number of characters per line (default = 76) 
number of lines per paae minus r. Example if lines per 
= 66 arid the number of blank lines between 


p 

d 


jO 0,’^ 0 


titles and footers 


A t 


then 


mm* w m» 


b'd 


r ~ number of b lank lines between text body and ea.oh header 


and footer. Default 


o 

O m 


For example to specify left marain to beain in column 5.- print 
width of 60.- 66 lines/paae.- and 4 spaces between text body 
and titles and footers t enter .m 5 60 62 4. 




H you enter oust .m 5 60, the previously entered values tor 

parameters <* arid r will he assumed. The mars in mas ye 

at any point as desired in the text. The maximum value tor n 
* 

IS it-. 


TURN OFF JUSTIFICRTION <.notill) 


Th^ .notill macro turns ott the Justitication tunctiun._ 

This means that the lines will toe printed JJi^out 

to make the margins come out even. Hl*u, word-, si e not uumtin.J 

to till to the srecitied marsins. 


BEGIN ft NEW PAGE <.tf> 

The .tt macro mas toe entered when one wants th< 
eject to the top ot the next pase. 


rinter to 


LITERAL SPACE <t character) 

Normally, spaces are not processed like other characters. 

It several spaces are entered consecutively, the bTP word 

processor reconizes only one space and !-* ’'* r _ t '7 n ’ =, Unp 

It it i-=: desired to torce a certain number ot sr■=>*-• *■.= it\ s. tin. 

tor tabular~tormats, etc., a string ot 

be inserted into the text. The caret will no.- jv - ■ - 

the text is processed tout instead a space w111 toe rr i n ..J +- 

each occurence ot the caret. 


TURN ON JUSTIFICATION <.ou) 


The .ju macro may toe entered in order to res ,or< 
.ju is normally used to revert back to justitication 
usins the .notill macro. 


j ustitication 
at ter 


RAGGED RIGHT MARGIN <.rr) 

Thi- macro turns ott the addition ot spaces in order to make 
the mar*ins"come out even. Words are sti11 combined in order 
to approximate the specitied number ot characters Per 

The lett marsin will toe straight tout the risht marsin will toe 
passed. 

RAGGED LEFT MARGIN <.rl) 

This macro is the same as the .rr macro except that the 
risht marsin is straight and the lett marsin is rassed. / 


SKIP NEXT N LINES <.ln) 

Use this macro to skip a number ot lines toetore printins the 
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next line of text. For example* to skin 2 lines end bee in 
printing enter .12. If you enter . 1 by itself* one will be 
assumed. Thus . I and .11 are equivalent arid each will result 
in a movement to the next line. 


CENTER LINE OF TEXT C.c text) 

This macro is useful for centering a line of text, 
example* to center the phrase STP Word Processor* enter 
.c STP Word Processor. 


For 


SWAP JUSTIFICATION MODES (.swap) 

This macro is used to switch from .rr mode to .rl and 
vice versa. 

PARAGRAPH SPECIFICATION <.p d r> arid PARAGRAPH IDENTIFICATION <.p> 

Use the .p d r macro to inform the word processor what a 
paragraph is supposed to be- d = number of lines down* and 
r = number of spaces risht for paragraph indent. The default 

is d = 1 * and r = 5. 

In order to identify a paragraph start in your text* 
use the .p macro with no parameters. 


PAGE TITLE (. t# title text) 

A one line title at the top of each rase may be entered us ins 
this macro. For example* to specify the title CONFIDENTIAL* enter 
.t CONFIDENTIAL. If you want to also include a rase number* 
enter . t# CONFIDENTIAL. Note that the # specifies pa.se number ins. 
If you want Just a pa.se number (the default state)* enter 
Just .t#. If you want neither title nor pa.se number* 
enter Just .t to turn off all tit 1ins. 


PAGE FOOTERS (.foot# foot text) 

A one line footer at the bottom of each pa.se may be s 
usins this macro. The parameters for .foot are the same a 
for the .title. The default is no footers. 


pecified 


CREATING SHAPE TABLES (.shape n and .set n l p) 

The STP Word Processor has provisions for printins text in 
various share formats by us ins a. table to control the risht 
and left mar-sins. The .share macro is used to define the share 
to be used. Share 1 is in the form of an ' I'' and entered by 
simply enterins the command .share 1 at the besinnins of the 
text f'i le. 
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The .-=:h.=<pp 2 macro may he used to create a user defined 
share. In"order to define the desired share., .set macros are 
u .=-prj tn make entries in the user share table correspondiny tu 
the"desired share. The parameters in the .set n 1 r are 
as f o 1 lows : 

n = line number for this mar-yin specification 
1 = column for left mar-yin start 

” f--|!Kfiber of characters tu ba mintad uh thi —■ lint* 

For example.. .set 14 5 40 defines line 14 as- left mar-yin starts 
in column 5, and there are 48 characters to be printed on this 

line. 

Nrirma 1 ly one would have to enter 6b set macros to complete 
+h P u-pr -hare table. But it should be noted that .set 8 Ip 
i-’a special case. The 8 (which would normally represent the 
line number) indicates that all lines in the file are set to a 
lpft mar-yin of 1 and print width of r. This is useful as yuu 
can set all lines in the user share table to a particular- 
mar-yin and then use non 0 values to chamse certain lines to 
form the desired share. 


Note : 


Always enter the .share 2 macro before the .set macro; 
The reason is that as soon as the .share 2 macru is 
encountered.- it fills the user share table to default 
values of left mar-yin = ©.. and print width - 48. Thu: 
if you enter .set macros first., they will ba 
overwritten by the .share ^ defaults- of 0 and 48. 


Ti- «?hare 2 is entered and no share uummands ai e enter eJ. 

,, * ~ ~ J *| *5 -j - & -1 * 14- 4*r, rvi fi 4fi Th i«; iM^ry us0tu 1 whsn 

the many ms will default tu . m u -tu. r,i - l - .... 

it is desired to view the formatted output un FETs- uhiun 
have 40 column screens. 


DEFAULT CONDITIONS 

The foliowiny are a number of assumed defauIts that exist un 
initial entry to the word processor. 

Justification = on 

Margins = 66 lines/raye, 3 blank lines between text body 

titles and footers., left mar-yin - 0.. end print 

width =76. 

Vertical Sraciny = 1 (siny le spaced output) 

Par-a.yrarh =1 line down and 5 space indent 
Pa.se Title = rase number but no text 
F'a-ye Footer = no text or rase number 


and 


HOW TO USE THE STP WORD PROCESSOR 

1) Load the word processor arid MAE via 
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lw f 


' 6 ) 


4) 


/WORDP.EKE 
AC 


Note : 


Basics Hi Mem pointer <1=34, *35> is set above the_ 
morel processor. Either poke this pointer to *U tm 
or retrain from usins Basic commands which use 

pro^ra/i! roemopy space- 


E r ,tpr upper C 3 S 6 / lowsr* case rnode v i a. “fcHe ]flL command 
Clear tormat mode via 3FORMAT CLEAR. 


Enter raw text usins MAE tor editins 
necessary text processins macros. 


Include all 


When you are t ini shed enter ins the raw text arid 
associated text macros., senerate a formatted output via : 


3 RIJN *708 
3RUN *703 


*r tor output to CRT on ly 

4- tor output to CRT and Printer 


EXAMPLE 

A raw text tile named WORDP.INS is contained on the diskette. 
Type 3GET "WORDP.EKE" to load this tile. Type 3PRINT to 
examine the raw text with associated macros. 

Tyre 3RIJN *700 (CRT only) or 3RUN *703 <CRT and Printer; to 
p.-jfp.r:ijte the word Processor and output the text in word processor 
tor-mat. Note : It you output this to a 40 column PET., it will 
not appear neat since the mar-sin was set tor 76 characters 

per line. 

Now compare the raw text printout with its text macros to the 
tor-matted output senerated by the word processor. Examine 
these two printouts unti1 you are familiar with the 
function of the STP macros. 


14. SPECIAL NOTES 

t When enter ins source modules ^without . EN; .• yuu can pertof m 
a short test on the module by assembling the module while 
in the text file and watchins for the !07 error. If 
other error messases occur., you have errors in the 
module]’ This short test is not a complete test but does 
check to insure you have lined up the fields proper ly> 
not entered duplicate labels within the module* or 
entered illesal mnemonics or addressins modes. 

$ fir, 80 character,-’ line output device should foe used when 
p.p i nit i Pis an assemb ly 1 i st i ns i n order to pruv i de a neat 


.«»» S"** & 


printout without toIdover to the next line. 

Immediately after using the PET Machine Language Monitor 
to save a program.- always X to Basic and then SVS 1024 
back to the monitor. The reason is that the IRQ vectors 
are destroyed by the PET save software. 

If you are soin* to use MAE and Basic together; alter 
HIMEM <§0034; $0035> so Basic will not clobber MAE; 
or i ts text or labe 1 f i les. 

Use duality diskettes like SCOTCH or BVSAH. A few 
dollars saved on a cheap diskette is not worth the 
risk of lost data. 

Due to some "strange" disk problems; never use the save 
with replacement feature <@) ~~ Example* 3PUT 11 @1 • TEST.M01 11 
or even SAVE " @ : FILE 11 .> 8. 


We recommend that a naming convention for your f i les 
be established. We use the followins extensions : 


name, 
name, 
name. 
name« 
name s 

name« 
name, 
name • 
name. 
name« 
name« 
name. 
name * 


CTL 

tmnaa 

Centro 1 F 

X 

X 

*«* 

— 

Modu le n 

ASM 

— 

Source f 3 

EXE 


Executab 

REL 

***** 

Re locatal 

MAC 


F i le con’ 

LIB 

•WWW 

Library < 

ML IB 

***** 

Library c 

DOC 

— 

Program 3 

INS 

ewM* 

User ins” 

NOT 

***** 

Program t 

BAS 

— 

Basic Pri 

DAT 

— 

Bas i c Da.’ 


15. ASSM/TEB USERS GROUP 

An ASSM/TEB Users Group has been formed by James Strasma for the 
exchange of programs and unidue modules. Most of the information 
this exchange is MAE compatiable. The cost per diskette is aIso 
minima1 but the information is extremely useful. 

Some of the more notable programs on the first diskette are : 


UNASSEMBLER/MAE 

KEVSQRT 
MAE/DOS.ASM 
EPROM PROGMR 

PET 16 


Basic program which disassembles into a disk 
file compatible with MAE. 

M.L. program for sorting Basic variables 
Source for the MAE/BOS Support pro-gram 
2716/2732 EPROM programmer which connects to 

User Port. 

Sweet 16 interpreter adapted for the PET 


For more details.- contact : 
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James Strasma 
c/o Grace U.M.C. 

120 West King Street 
Decatur.- Ill. 62521 


16. EXAMPLE LISTING 

An example of a program in MAE's syntax This proyrafft 

i._ the uflRT driver contained on the supplied diskette under ti les 

HART.CTL.. UART.M01 ; UART.M02.. UART.M03. 

The UART driver program has three entry points : 


1> SET.BAUD - 


UART.OUT 
3) UART.IN 


2 ;* 


Optional entry used to automatically measure user- 

terminal baud rate. 

Output character in RA.>. 

Input chBi’"'3.c1 0 r* 3nd n&tufTi in h. %H.•*« 


Note : 


The UART program is free to use by MAE purchasers for 
n.-.n-nnmrr.pri. purpose. For cornmerlca 1 use., rue on ly r e-nue^T 
+i" t ‘,; ri , 4 briefly write describing the use of the UART program. 
I'W're'Huest no monetary payment or any other renumeration. 


i i 
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2000 ' 
>081 ■ 


0010 

. CT 

DESIGNATE AS CONTROL 

0020 



0030 

f-p 

m wL~. 

;CONTINUE IF ERRORS 


0040 

«** a - **. 

0050 

yy€y 

0070 

0080 

0090 

0 1 00 
0110 
0120 


. BA f-2000 

+++++++ DEFINITIONS ++++++++ 


DE SE841 
DE fE843 

I I r* **L rl 1 pi rl r 1 rf FI r 

t* rr ^ $ s| o^s |***». ***% i** 
«L»* G. a X %**«*>«* * 


0140 
0150 
0160 
0170 
0i80 
0190 
0200 
0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0230 

0300 


pIA.PORT 
PIA.DIR 

MSK.1N 
MSK.OUT 


HART CONTROL PARAMETERS= 


NO.RABBITS .DS 1 


BIT.TIME 


is 1 


;PIA DATA PORT 
PI A DIRECTION POR 


;INPUT IS ON BIT 6 
OUTPUT IS ON BIT 


NO. OF PAD BITS ON CR LF 
BAUD RATE CODE <0~7> 


110 
300 
600 
200 


4800 

7200 

9600 


FI D8 "III 


** • C; 

S « * 


ET BAUD AND TABLE DELAVS 


07F6 233E-2B34 UART.M81 

0010 

0020 

0030 


2011 - 
2013- 
2016- 
2018' 


+ ♦<«|*<» ot|e* «*jj*** «*|*» ShT BAUD RATE +++++ 


602- 

pi r 



0040 SET.BAUD 

PHP 

003- 

-70 
l* »-.* 



0050 

OP T 

m4 — 

AD 

43 

m 

CO 

0060 

LDA 

907- 

«** om_ 

23 

BF 


mh7h 

AND 

009- 

09 

80 


0080 

ORA 


8D 

43 

E8 

0090 

STA 


20 47 20 
D0 FB 
AD 41 E8 
29 40 
F U F 9 


••• *•* 
201H- 

to* *** 

fly 

00 

90 m- 

HD 

41 

20 IF- 

OQ 

40 

VliV 1 — 

Ik*** ***** u*** *•» 

F0 

07 

LUilv' 

V** OP* 

s :h 
«*• *** 

FF 


DM M® ****>« 

2025 ' 


F@ F5 


0 i 00 

0110 LF'i 
0120 

0130 LP2 
0140 
0150 
0160 

0170 LP3 
0180 
@ 190 
0200 
0210 


J SR 
BNE 
LDA 
AND 
BEG! 
LDV 
LDA 
AND 
BEQ 
CPV 
BEQ 


GET.BIT 
LP1 

PI A.POR 
#MSK.IN 
LP2 


PIA.PORT 
#MSK.IN 
GOT.COUNT 
#$FF 
LP3 


SAVE PSR 

CLEAR INTERRUPTS 

INITIALIZE PORT ON LOGON 

; * 


; BR. IF ALREADY SPACING 


BR. IF MARKING 
; CLEAR FOR DELAY FACTOR 
;GET BIT 
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*“■« l"j •“*» "*? 

*•' 1 .**' 1* 

8m*« 1— mm 1 

ro 



•**"| f**j[ •***» !***! 

dUdC'- 

B0 

F2 


202 R- 

38 



202B- 

R0 

00 


202 B- 

B9 

3F 

20 

20 :; 

30— 

B@ 

03 


amt M* M 

VH 

Imaot MM *■ 

— 

J u. 

1*"* o 

i .1 1 

mm m* 



2 fir 

m mm* 

t ’ t 
'l .^1 

B0 

F8 


20 :! 

: ;5— 

w mmm 

or 

01 

20 

20 v 

Z* O — . 

:*o 

fl2 

0C 


28:: 

3fi— 

20 

BE 

20 

20 v 

3B- 

28 



mmm • 

VL-i 

|, f - V *« 

3E- 

•mm mm 

by 




203F- 

FF 

2040- 

mm mm 

M - 

mm* 'in* 

2041 - 

4fi 

2042- 

•-« cr 
cl-J 

2043- 

12 

2044- 

0 fi 

2045- 

07 

2046- 

00 


2047- 

fiB 

41 

m 

iTi 

204H- 

vQ 

tmm mmm* 

48 


204C- 

66 



204B- 

fiB 

01 

28 

2050- 

18 



2051- 

B8 



2052- 

69 

08 


2054- 

fi8 



2055- 

4C 

5B 

20 

2058- 

fiC 

01 

20 

205B- 

B3 

66 

20 

205E- 

F0 

16 


2868- 

A8 



2061 - 

88 



2062- 

B0 

FB 


2064- 

Efi 



tan mmm mm mmm 

uL'HbS- 

60 




v M 66 ~~ 

mm mmm 

00 

2867- 

00 

2068- 

00 

2069- 

9fi 

206fi- 

47 

2 U6B- 

IB 

206C- 

0F 

206B- 

08 

206E- 

00 


0229 
0230 
0240 
0250 
0260 
0270 
0280 
0230 
0300 
03 i 0 
0320 
0330 
0340 
0350 
0360 

0370 
0380 
0330 
0400 
04 i 0 
0420 

0430 

0440 

0450 

0460 

0470 

0480 

0430 
0500 
0510 
0520 
0530 
0540 
0550 

0560 
0570 
0580 
0530 
0600 
0610 
0620 
0630 
0640 
0650 
0660 


SKP.FF 
GOT.COUNT 
LP.FI 


GOTBfiUB 


TBLBfiUB 


GET.BIT 


DEL0.5 


IiLVFULL 


EH0.5 


LOOPDEL1 


INV 


BHE LP3 


TVfi ;MOVE 

LBV #08 

CMP TBLBfiUB.. V 

BCS GOTBfiiJB 

I NV 

BNE LP.FI 

COUNT TO R < fi > 

STV BIT.TIME 

STORE BfiUB RATE COBE 

LBN #12 

JSR F'fiB.BELN 

PLF' 

RTS 

WfiIT UNTIL ALL BITS HAVE 

.BV 255 

; >= 110 

.BV 147 

; >= 300 

.BV 74 

; >= 608 

Ts II 07 

. r» t o i 

>= 1208 

.BV 18 

; >= 2408 

.BV 18 

; >= 4808 

.BV 7 

; >= 7200 

.BV 0 

>= 9608 

LBfi PIft.PORT 

GET KEVBOfiRB INPUT 

fiNB #MSK.IN 

RTS 

LBfi BIT.TIME 

CLC 

CLB 

ABC #08 

TRV 

JMP ENG.5 

LBV BIT.TIME 

LBfi UB.TBL1,V 

BEG! NOT. THIS 

TfiV 

.* T* 

BEV 

BNE LOOF'BEL 1 

NOP 

RTS 



0670 

0680 

0630 

0700 

0710 

0720 

0730 

0740 

0750 

0760 

0770 

0788 

0730 


;-BELfiV 

IJD.TBLl 


+ 19 

BV 

00 

BV 

00 

BV 

00 

BV 

154 

BV 

71 

BV 

29 

BV 

15 

BV 

CO 

CD 



BELfiV FULL FOR 110 BAUD 
j BELfiV FULL FOR 380 * 
BELfiV FULL FOR 600 * 
BELfiV FULL FOR 1200 * 

; BELfiV FULL FOR 2400 * 

; BELfiV FULL FOR 4808 * 
BELfiV FULL FOR 7208 * 
BELfiV FULL FOR 3600 * 


BELfiV 0.5 FOR 118 BftUB 






206F- 00 
2870- 00 

2071- 48 

2072- IF 

2073- 0Fi 

2074- 03 

2075- 01 


2076- 
2073- 
2070- 
207D- 
‘2080- 
2081 ■ 
2084- 

•"•HO "7 

tvui 

OHOQ 
- Hi tit 

BtM* «M •» *** 

2089 

?08B 


ftp Pi 

48 48 
4 c* 4o 


e.y bo bo 


iL. «»* 

ru s 


sL, «~* 

Du 

r* o 
O O 


/ . J_8 

H o 


iU 

Ct 8 _t 


208C- 

208D- 

208E' 


'HQv- 


B0 EF 

60 


>«Mi 

• 11 • 
o o 

1 F 

*$» &K9** 

00 00 00 

00 00 


er •-» 

Oo 


IE 

IM «•* «* «** ***• 

?096- 0E 


0800 

0810 

0828. 

0830 

0840 

0850 

0860 

0870 

0880 NOT.THIS 
0890 

0300 LOOPBEL2 


pi I (SjS 

BV 00 

K V .• .«.* 

§ 3 &<***» 

BV 31 
BV 10 


DELftV 0.5 
IiELftV 0.5 
BELfiV 0.5 
DELFiV 0.5 
;BELRV 8.5 
DELflV 0.5 
;DELflV 0.5 


FOR 380 
FOR 600 
FOR 1206 
FOR 2400 
FOR 4800 
FOR 7200 
FOR 9600 


LDFi IJB.TBL; 


* 

L. .* T 


TfiV 


BV $48 $48 $48 $48 $48 $48 $48 


BV $68 $68 $68 $68 $68 $68 $ 


■fay 


0920 DEV 

0330 BNE LOOF'D 

0340 RTS 

0958 

i *—--BELfiV=54ft+<£.<£. 

0370 UD.TBL2 .BV 167 

0980 * BV 60 

0330 .BV 30 

1 Pififi . BV 00 0 


:»x c* 


0390 
1000 


0 00 010 


1010 
1 020 
1030 


1 050 
0310 


DELAV=54X+3i 
.BV 83 
.BV 30 
.BV 14 
.FI D8 


IRRT. M0S 


;DELflV FULL FOR 110 BAUD 
;DELflV FULL FOR 300 * 

;DELflV FULL FOR 600 # 


;DELflV 0.5 FOR 110 BAUD 

;DELflV 0.5 FOR 3O0 * 

DELflV 0.5 FOR 600 * 

; IJART OUTPUT DRIVER 


6343 233E-2681 UflRT 


2M97- 

’ «* M *~j W 

w. \U «.* 

V |.*10 M 

2090- 
209D- 

208E- 

209F- 

20FH- 

20H2- 
20H4- 
20A5- 
20A8- 
20AB- 
20AC- 
20AD- 
20AE- 
20flh • 

20B1 


Ho 

"?o 

i* IU 

20 HE 20 

28 

60 

48 

49 FF 
48 

A2 0B 


• j s» 

oo 


20 D2 

20 58 

£0 

no 

4A 

48 

CA 

D0 F4 
68 


20 

20 


00 1 0 

0020 +++ 

0030 

0040 IJART. OUT 

0050 

0060 

0070 

0080 

0090 

0100 IJART. OUT 1 

0110 
0 120 
0130 

0140 

0150 LP. IJOUT 

0160 
0170 
0180 
0190 
0200 
0210 
0220 


+++ ++ UflRT OUTPUT +++++ 


PHP 

SEI 

3 SR IJART. OUT 1 

PLP 

RTS 


F'Hfi 

EOR #$FF 
F'HA 

LDX #11 
SEC 

JSR BIT.OUT 
.JSR DLVFULL 
F'LA 

LO Q C| 

PHA 

Il£V 

BNE LP. IJOUT 

PLA 


SAVE C 


; RESTORE PSR AND RETURN 


; INVERT 

11 BITS : 1 STOP, 8 DATA 

;BIT TO PORT 
;DELflV FULL BIT TIME 
;RESTORE R(A> 

;NEXT BIT 
AND SAVE 


LOOP 

REMOVE JUNK 
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0B2- 

68 



0230 


PLA 

0B3- 

29 

7F 


0240 


AND 

0B5- 

C9 

0D 


0250 


CMP 

0B7- 

F0 

0B 


0260 


BEQ 

0B9- 

C9 

0A 


0270 


CMP 

8BB- 

F0 

07 


0280 


BEQ 

0BD- 

60 



0290 


RTS 





0300 



0BE- 

48 



0310 

PAD.DELX 

PHA 

:0BF- 

E0 

00 


0320 


CPX 

:0C1- 

4C 

C8 

20 

0330 


JMP 



* 


0340 

• 


0C4- 

48 



0350 

PAD.DEL 

PHA 

0C5- 

AE 

00 

20 

0360 


LDX 

0C8- 

F0 

06 


0370 

PAD.DELEN 

BEQ 

0CA- 

20 

58 

20 

0380 

LP. F'DEL 

JSR 

0CD- 

CA 



0390 


DEX 

0CE- 

D0 

FA 


0400 


BNE 

0D0" 

68 



0410 

EX.DEL 

PLA 

0D1- 

60 



0420 


pxq 





0430 



•10D2- 

HD 

41 

E8 

0440 

BIT.OUT 

LDA 

•■0D5- 

vQ 

7F 


0450 


AND 

i0D7- 

90 

02 


0460 


BCC 

20D9- 

09 

80 


0470 


ORA 

20DB- 

8D 

41 

E8 

0480 

SKP.BOUT 

ST A 

>0Dh- 

60 



0490 


RTS 





0500 







0510 







0320 


.FI 

•1248 

■“ ■ j 

C---' 

3E- 

2586 

UART.M03 



JMP PAD.HELEN 


;RESTORE CHAR. 
;CLEAR BIT 7 
; CR 


;LF 


PRESERVE 

j GET # OF PAD BITS 
;SKIP IF ZERO 
;DELAY 

LOOP 

RESTORE 


;PUT BIT 


.FI DS "UART.M03" ;UART INPUT DRIVER 


20DF 


20E1- 

28E3 

20E4 

20E7 


08 

"70 

I 


A 9 00 
48 

2W 47 
D8 FB 


M* 

2U 


20E9- 20 47 20 
20EC- F0 FB 


20 EE 
20F1 • 


20 4D 20 
20 47 20 


* *u 

.1 o 


20F5- 

20F7- 

20F8- 

20F9- 

20FA' 

20FC- 

28FD- 

2100 ' 


D0 01 

18 

►TO 

Du 

6A 

B0 @7 
48 

20 58 20 
1 


ij 

o 


0010 
0020 ; 

0030 

0040 UART.IN 

0050 

0060 

0070 

0080 LP.UI1 

0090 

0100 

0110 LP.UI2 
0120 
0130 
0140 

0150 LP.UI3 
0160 
0170 
0180 

0190 SKP.UI1 
0200 
0210 
0220 
0230 
0240 


+++++ HART INPUT +++++ 


PHP 

SEI 

LDA #00 
PHA ; 

JSR GET.BIT 
BNE LP.UI1 

JSR GET.BIT 
BEQ LP.UI2 


JSR 

JSR 

SEC 

BNE 

CLC 

PLA 


DEL0.5 
GET.BIT 

SKP.UI1 


A 

DONE.UI 


BCS 
PHA 

JSR DLVFULL 
CLC 


* 


CLEAR CHAR. 

; GET BIT 

;LOOP UNTIL NO BIT 
;GET BIT 

;LOOP UNTIL START BIT 

DELAY UNTIL MIDDLE OF STfl 
;GET BIT 
;ASSUME SPACE 


NO IT I 


8 MHRK 


;ROTATE RIGHT INTO CARRY 


;DELAY UNTIL MIDDLE OF NEX 


:* r*o po no po 
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101- 90 EE 


103- 
105- 
107' 
iil08‘ 


49 FF 
29 7F 
28 
60 


0250 

0260 DONE.UI 

0270 

0280 

0290 

0330 

0340 

0350 

0360 END.PGM 




LABEL.FILE 


X LP.U 


EOR #$FF 
AND #$7F 
PLP 
RTS 


EN 


;LOOP FOR NEXT BI 
;INVERT 
CLEAR BIT 7 
;RESTORE PSR AND 


RETURN 


BIT. OUT =20D2 
BLVFULL =2058 
END. PGM =2189 
GOT. COUNT =282A 
L00PDEL2 =207A 
LP.IJIl =20E4 
LP.IJOUT =20 A5 
LP3 =201C 
NO. PAUDITS =2000 
PAD.HELEN =20C8 
FT A. PORT =E841 
SKP.FF =2828 
IJART.IN =20DF 
UD.TBL1 =2066 
,-70000,2109,2109 


BIT.TIME =2001 
DONE.UI =2103 
EX.DEL =20D0 
GOTBAUD =2035 
LF'.FI =202D 
LP.U12 =20E9 
LP1 =208E 
MSK.IN =0040 

NOT.THIS =2076 
PAD.DELX =20BE 
SET.BAUD =2002 
SKP.UI1 =20F8 
UART.OUT =2097 
UD.TBL2 =208C 


DEL0.5 =204D 
EN0.5 =205B 
GET.BIT =2047 
LOOPDEL1 =2061 
LP.PDEL =20CA 
LP.UI3 =20F1 
LP2 =2013 
MSK.OUT =0080 

PAD.DEL =20C4 
FT A. DIR =E843 
SKP.BOUT =20DB 
TBLBAIJD =203F 
UART. OUT1 =209E 






I 


\ 

J 



620 S. Peace Haven Road 
Winston-Salem, N. C. 27103 

WE WILL ASSIST WITH SPECIAL DESIGNS 


(919) 765-2665 


JOHNNY & HAZEL WEISNER 














ERROR 

Lmmu 9 m W •» m 


ERROR CODE 


IB 

lfl 

19 

18 

17 

16 

15 

14 

13 

12 

11 

10 


0F 

0E 

0D 

0C 


0B 

0A 

09 

08 

07 

06 



01 

00 
tm tmm 

ED 


DESCRIPTION 


.EN in non .CT file when .CT file exists. 

.EN missin* in .CT designated file. 

Found .FI in non .CT file. 

Checksum error on disk load. 

Syntax error in JED command. 

Dev i ce numbers 0 .< 1 > 2 > 3 not a 1 lowed. 

Mu It i p le .CT assisnment. 

Command syntax error or out of ramie error. 
Missins parameter in 3NU command. 

Overflow in line # renumbering. 

CAUTION : You should properly renumber the 
the text file for proper command operation. 
Overflow in text file - line not inserted. 
Overflow in label file - label not inserted. 
MAE expected hex characters* found none. 
Illesal character in label. 

Unimp lemented addressins mode. 

Error in or no operand. 

Found illesal character in decimal strins. 
Undefined label <may be illesal label). 

.EN pseudo op missins. 

Dup licate labe l. 

Label missins in .DE or .DI pseudo op. 

.BA or .MC operand undefined. 

Illesal pseudo op. 

Illesal mnemonic or undefined macro. 

Branch out of ranse. 

Not a. zero pa.se address. 

Error in command input. 


2F 

2E 

2D 

2C 

2B 

2A 


C.U» 


26 

~iET 

24 

•"*1 •*"| 
m 

C.O 

22 

21 

20 


Overflow in file sequence count <2ft16 max.) 
Overflow in number of macros <2tt16 max.) 


.ME without associated .MD 
Non-symbolic label in SET pseudo 
11 lesa. I nested def i n i t i on. 


OP. 


Macro definition overlaps file boundary. 

Dup l icate macro definition. 

Quantity parms mismatch or illesal characters 
Too many nested macros <32 max.) 

Macro definition not complete at .EN 
Conditional suppress set at .EN 
Macro in expand state at .EN 
Attempted expansion before definition. 












